<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      OpenSP-1.5.2
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-2020-04-02">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 2020-04-02
      </h4>
      <h3>
        Chapter&nbsp;48.&nbsp;Standard Generalized Markup Language (SGML)
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="sgml-dtd.html" title="docbook-4.5">Prev</a>
          <p>
            docbook-4.5
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="openjade.html" title=
          "OpenJade-1.3.2">Next</a>
          <p>
            OpenJade-1.3.2
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="sgml.html" title=
          "Chapter&nbsp;48.&nbsp;Standard Generalized Markup Language (SGML)">
          Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="opensp" name="opensp"></a>OpenSP-1.5.2
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to OpenSP
        </h2>
        <p>
          The <span class="application">OpenSP</span> package contains a
          <span class="application">C++</span> library for using SGML/XML
          files. This is useful for validating, parsing and manipulating SGML
          and XML documents.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://downloads.sourceforge.net/openjade/OpenSP-1.5.2.tar.gz">
                https://downloads.sourceforge.net/openjade/OpenSP-1.5.2.tar.gz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: 670b223c5d12cee40c9137be86b6c39b
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 1.5 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 32 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: 1.0 SBU
              </p>
            </li>
          </ul>
        </div>
        <h3>
          OpenSP Dependencies
        </h3>
        <h4>
          Required
        </h4>
        <p class="required">
          <a class="xref" href="sgml-common.html" title=
          "sgml-common-0.6.3">sgml-common-0.6.3</a>
        </p>
        <h4>
          Optional
        </h4>
        <p class="optional">
          <a class="xref" href="xmlto.html" title=
          "xmlto-0.0.28">xmlto-0.0.28</a>
        </p>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/opensp">http://wiki.linuxfromscratch.org/blfs/wiki/opensp</a>
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of OpenSP
        </h2>
        <p>
          Install <span class="application">OpenSP</span> by running the
          following commands:
        </p>
        <pre class="userinput">
<kbd class="command">sed -i 's/32,/253,/' lib/Syntax.cxx &amp;&amp;
sed -i 's/LITLEN          240 /LITLEN          8092/' \
    unicode/{gensyntax.pl,unicode.syn} &amp;&amp;

./configure --prefix=/usr                              \
            --disable-static                           \
            --disable-doc-build                        \
            --enable-default-catalog=/etc/sgml/catalog \
            --enable-http                              \
            --enable-default-search-path=/usr/share/sgml &amp;&amp;

make pkgdatadir=/usr/share/sgml/OpenSP-1.5.2</kbd>
</pre>
        <p>
          To test the results, issue: <span class="command"><strong>make
          check</strong></span>. As many as nine of the 23 tests may fail. Do
          not be alarmed.
        </p>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">make pkgdatadir=/usr/share/sgml/OpenSP-1.5.2 \
     docdir=/usr/share/doc/OpenSP-1.5.2      \
     install &amp;&amp;

ln -v -sf onsgmls   /usr/bin/nsgmls   &amp;&amp;
ln -v -sf osgmlnorm /usr/bin/sgmlnorm &amp;&amp;
ln -v -sf ospam     /usr/bin/spam     &amp;&amp;
ln -v -sf ospcat    /usr/bin/spcat    &amp;&amp;
ln -v -sf ospent    /usr/bin/spent    &amp;&amp;
ln -v -sf osx       /usr/bin/sx       &amp;&amp;
ln -v -sf osx       /usr/bin/sgml2xml &amp;&amp;
ln -v -sf libosp.so /usr/lib/libsp.so</kbd>
</pre>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <span class="command"><strong>sed -i
          's/32,/253,/...unicode.syn}</strong></span>: These seds prevent
          some annoying messages that may otherwise appear while running
          <span class="command"><strong>openjade</strong></span>.
        </p>
        <p>
          <em class="parameter"><code>--disable-static</code></em>: This
          switch prevents installation of static versions of the libraries.
        </p>
        <p>
          <em class="parameter"><code>--enable-http</code></em>: This switch
          adds support for HTTP.
        </p>
        <p>
          <em class="parameter"><code>--disable-doc-build</code></em>: This
          switch prevents the <span class=
          "command"><strong>configure</strong></span> script checking if you
          have <span class="application">xmlto</span> installed. If you have
          <span class="application">xmlto</span>, you can remove this option.
        </p>
        <p>
          <em class=
          "parameter"><code>--enable-default-catalog=/etc/sgml/catalog</code></em>:
          This switch sets the path to the centralized catalog.
        </p>
        <p>
          <em class=
          "parameter"><code>--enable-default-search-path</code></em>: This
          switch sets the default value of <code class=
          "envar">SGML_SEARCH_PATH</code>.
        </p>
        <p>
          <code class="option">--enable-xml-messages</code>: This switch adds
          support for XML Formatted Messages.
        </p>
        <p>
          <span class="command"><strong>make
          pkgdatadir=/usr/share/sgml/OpenSP-1.5.2</strong></span> : This sets
          the pkgdatadir variable in the <code class=
          "filename">Makefile</code> from <code class=
          "filename">/usr/share/OpenSP</code> to <code class=
          "filename">/usr/share/sgml/OpenSP-1.5.2</code>.
        </p>
        <p>
          <span class="command"><strong>ln -v -sf ...</strong></span>: These
          commands create the <span class="application">SP</span> equivalents
          of <span class="application">OpenSP</span> executables and
          libraries.
        </p>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">onsgmls, osgmlnorm, ospam, ospcat,
              ospent, osx, and the <span class="application">SP</span>
              equivalent symlinks: nsgmls, sgml2xml, sgmlnorm, spam, spcat,
              spent, and sx</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Library:</strong>
              <span class="segbody">libosp.so and the <span class=
              "application">SP</span> equivalent symlink: libsp.so</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">/usr/include/OpenSP,
              /usr/share/doc/OpenSP, and /usr/share/sgml/OpenSP-1.5.2</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="onsgmls" name="onsgmls"></a><span class=
                    "term"><span class=
                    "command"><strong>onsgmls</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is used to process SGML files.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="osgmlnorm" name="osgmlnorm"></a><span class=
                    "term"><span class=
                    "command"><strong>osgmlnorm</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    prints on the standard output a normalized document
                    instance for the SGML document contained in the
                    concatenation of the entities with system identifiers .nf
                    and .fi.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="ospam" name="ospam"></a><span class=
                    "term"><span class=
                    "command"><strong>ospam</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a markup stream editor.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="ospcat" name="ospcat"></a><span class=
                    "term"><span class=
                    "command"><strong>ospcat</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    prints effective system identifiers found in the
                    catalogs.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="ospent" name="ospent"></a><span class=
                    "term"><span class=
                    "command"><strong>ospent</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    provides access to <span class=
                    "application">OpenSP</span>'s entity manager.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="osx" name="osx"></a><span class=
                    "term"><span class="command"><strong>osx</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is an SGML normalizer or used to convert SGML files to
                    XML files.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="nsgmls" name="nsgmls"></a><span class=
                    "term"><span class=
                    "command"><strong>nsgmls</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a symlink to <span class=
                    "command"><strong>onsgmls</strong></span>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="sgml2xml" name="sgml2xml"></a><span class=
                    "term"><span class=
                    "command"><strong>sgml2xml</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a symlink to <span class=
                    "command"><strong>osx</strong></span>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="sgmlnorm" name="sgmlnorm"></a><span class=
                    "term"><span class=
                    "command"><strong>sgmlnorm</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a symlink to <span class=
                    "command"><strong>osgmlnorm</strong></span>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="spam" name="spam"></a><span class=
                    "term"><span class=
                    "command"><strong>spam</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a symlink to <span class=
                    "command"><strong>ospam</strong></span>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="spcat" name="spcat"></a><span class=
                    "term"><span class=
                    "command"><strong>spcat</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a symlink to <span class=
                    "command"><strong>ospcat</strong></span>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="spent" name="spent"></a><span class=
                    "term"><span class=
                    "command"><strong>spent</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a symlink to <span class=
                    "command"><strong>ospent</strong></span>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="sx" name="sx"></a><span class="term"><span class=
                    "command"><strong>sx</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a symlink to <span class=
                    "command"><strong>osx</strong></span>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libosp" name="libosp"></a><span class=
                    "term"><code class="filename">libosp.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    contains functions required by the <span class=
                    "application">OpenSP</span> programs to parse, validate
                    and manipulate SGML and XML files.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libsp" name="libsp"></a><span class=
                    "term"><code class="filename">libsp.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a symlink to <code class="filename">libosp.so</code>.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-03-24 14:19:44 -0500
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="sgml-dtd.html" title="docbook-4.5">Prev</a>
          <p>
            docbook-4.5
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="openjade.html" title=
          "OpenJade-1.3.2">Next</a>
          <p>
            OpenJade-1.3.2
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="sgml.html" title=
          "Chapter&nbsp;48.&nbsp;Standard Generalized Markup Language (SGML)">
          Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
